home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu498.dms / pu498.adf / IEv4Demo / IE.Doc < prev    next >
Text File  |  1993-07-31  |  34KB  |  777 lines
  1.                    IE - The Complete Icon Editor
  2.  
  3.                                                  by Peter Kiem
  4.                                                     15 Penfold St
  5.                                                     Hillcrest, QLD 4118
  6.                                                     Australia
  7.                                                     (07) 800-8459
  8.                                                     kiem@splat.paxnet.com.au
  9.                                                     FidoNet: 3:640/304
  10.  
  11.  
  12. ABOUT IE
  13. --------
  14.     IE is a shareware program which allows the creation and editing of icons
  15. on the Amiga personal computer.  Using IE you can make icons much larger and
  16. easier than using the supplied icon editor on your system disks.
  17.  
  18.     You do not have to mention in your documentation that the icons were
  19. created with IE, but it would be nice for you to include a message like:
  20.  
  21.     Icons created with IE - The Complete Icon Editor
  22.  
  23.  
  24.  
  25. DEMONSTRATION VERSION CHANGES
  26. -----------------------------
  27.     The demonstration version of IE is fully functional so you can test all
  28. the functions of IE and determine if you wish to register or not.  To
  29. encourage you to register IE, the demonstration version also has a few
  30. changes:
  31.  
  32.     -   After starting the demonstration version of IE two requesters will
  33.     be displayed giving information about the demonstration version and
  34.     about obtaining a registered copy of IE.  These requesters will
  35.     disappear after 30 seconds each and you can then continue with IE.
  36.  
  37.     -   The demonstration version will also exit after any "save" operation
  38.     is performed.  This is done so you can see the effects of changing an
  39.     icon with IE rather than totally disabling the save functions as some
  40.     demonstration programs do.
  41.  
  42.     When you register your copy of IE you receive a registration number and
  43. a fully operational copy of IE with your name coded into the title bar as
  44. proof of your registration.  You will also be entitled to upgrades (for a
  45. small fee) if I create new versions of IE.
  46.  
  47.     I am not making a living from writing IE so I have not charged as much
  48. as I could had I marketed it commercially.  A fully registered version of IE
  49. will only cost you AUD$20.  Please respect the amount of time and effort I
  50. have put into IE and consider the small fee asked if you continue to use this
  51. program.
  52.  
  53.     Updates are available to registered users by returning your ORIGINAL disk
  54. to me at the above address along with a postage and handling charge of:
  55.  
  56.     Australia      AUD$ 5
  57.     Overseas       AUD$10
  58.  
  59.  
  60.  
  61. DISTRIBUTION OF IE
  62. ------------------
  63.     You can freely distribute the DEMONSTRATION version of IE as long as the
  64. following is observed:
  65.  
  66.     -   The program and documentation must be distributed together and are
  67.     not modified in any way.  The only exception is that the program and
  68.     documentation may be compressed into an archive for uploading to
  69.     Bulletin Boards or for other electronic transmission.
  70.  
  71.     -   The program is not used commercially or included in a commercial
  72.     package for profit unless written authorisation from me is obtained
  73.     first.  The demonstration version of IE may be freely included on public
  74.     domain library disks or compilation disks provided only a small fee is
  75.     charged for the service.
  76.  
  77.     A REGISTERED version must NEVER be distributed in ANY way.
  78.     (after all, you paid for it - so should others).
  79.  
  80.  
  81.  
  82. IE SYSTEM REQUIREMENTS
  83. ----------------------
  84.     IE requires Workbench 2.04 or later.  The functions used for IEv4.0 are
  85. not available in Workbench 1.3 or earlier.  If you require a version of IE
  86. for Workbench 1.3 or earlier then you can obtain IEv3.0 from me at the above
  87. address.  A demonstration version of IEv3.0 is on Fish Disk 621.
  88.     IE also requires "asl.library" and "diskfont.library" to be present in
  89. your LIBS: directory.  Unless you have removed libraries from your boot disk
  90. you will not have to worry about this.
  91.     IE will now quite happily run in 1/2 Meg memory using the default image
  92. size, screen resolution and number of colours unlike IEv3.0 which required 2
  93. Meg of memory.
  94.  
  95.  
  96.  
  97. WHAT ARE ICONS?
  98. ---------------
  99.    Icons are the pictures on Workbench that allow you to start a program,
  100. select a document or examine the contents of a disk.  These icons can also
  101. have a second picture which is displayed when the icon is selected giving
  102. the appearance of motion etc.
  103.  
  104.     Icons can also pass information to the tool called through the use of
  105. "Tool Types".  IE will also allow you to edit these and more.
  106.  
  107.     There are five different types of icons representing the different types
  108. of files on the Amiga:
  109.  
  110.     DISK ICON - To represent disks or harddrive partitions.  (NOTE: A disk
  111.     icon will only be displayed when it is named "disk.info" and is in the
  112.     top directory of a disk or HardDrive partition).
  113.  
  114.     DRAWER ICON - To represent a drawer (directory) on a disk.
  115.  
  116.     TRASHCAN ICON - To represent the special drawer known as the Trashcan
  117.     which is used for deleting files.
  118.  
  119.     TOOL ICON - To represent an executable program.
  120.  
  121.     PROJECT ICON - To represent a document, drawing, picture etc that is
  122.     passed to the tool for being edited.
  123.  
  124.  
  125.  
  126. INSTALLING IE
  127. -------------
  128.     IE can be simply installed on your system by dragging the IE icon into
  129. window on your disk that you wish to place IE into.  No special assigns or
  130. "hidden" files are used by IE.
  131.     It is recommended however, that the entire IE drawer is copied so you can
  132. always find the documentation files.
  133.  
  134.  
  135.  
  136. STARTING IE
  137. -----------
  138.     The simplest method of starting IE is by double-clicking on the IE icon
  139. from Workbench.  This will start IE ready to create an icon.
  140.  
  141.     Another method of starting IE from Workbench is to single-click on a
  142. project icon, hold down the "shift" key and double-click on the IE icon.
  143. This will start IE and automatically load the project icon for editing.
  144.  
  145.     IE can also be started from the CLI by typing "IE" optionally followed
  146. by the name of the icon to load.  This icon can be of any type and the
  147. ".info" suffix needed not be included in the name.
  148.  
  149.     The tooltypes and CLI parameters that IE accepts are listed at the end of
  150. this document.  These allow you to select the screen resolution and interlace
  151. settings for the IE screen, the number of colours the icon should contain and
  152. to increase the maximum image size that IE works with.
  153.  
  154.  
  155.  
  156. THE ICON DISPLAY WINDOW
  157. -----------------------
  158.     On the main IE window there is a large square region on the left hand
  159. side.  In this window the icon being edited is displayed 8 times normal
  160. size.  This magnification can be changed by moving the slider gadget above
  161. the display window.  This slider does not actually change the size of the
  162. icon but how large each pixel is displayed in the edit window.
  163.  
  164.     To see different parts of the icon simply click, or slide, the
  165. horizontal and vertical scroll bars next to the display window.  This allows
  166. you to move quickly around the image.
  167.  
  168.     Alternatively you can click on the arrow gadgets next to the scroll bars
  169. to shift the display one pixel at a time in the direction of the arrow.
  170. Holding down the left mouse button on one of these arrow gadgets will
  171. continuous scroll the image a pixel at a time in that direction.
  172.  
  173.     The "H" gadget in the top-right corner of the display window returns the
  174. horizontal and vertical scroll bars quickly to the "Home" position (that is,
  175. with the top-left corner of the icon being displayed).
  176.  
  177.     Underneath the display window are the current coordinates of the pointer
  178. within the icon and the name of the icon currently being edited.
  179.  
  180.  
  181.  
  182. SELECTING WHICH ICON IMAGE TO EDIT/DISPLAY
  183. ------------------------------------------
  184.     Icons can be made of one or two images.  The first image is the image
  185. displayed on the Workbench screen before any selection is made and is called
  186. the "Normal Image".  The second (optional) image is displayed when the icon
  187. is selected and is called the "Selected Image".
  188.  
  189.     To the right of the "H" gadget is the Image Select gadget.  This gadget
  190. allows you to select which image you are displaying/editing.  Click on this
  191. gadget to switch between the two images.
  192.  
  193.  
  194.  
  195. THE UNDO EDIT GADGET
  196. --------------------
  197.     Just underneath the Select Image gadget is the Undo Edit gadget. As the
  198. name suggests, this gadget will "undo" the last editing operation.  This
  199. enables you to reverse the effects where the edit you performed was
  200. incorrect (e.g. If your Flood-Fill leaked and destroyed your image, then
  201. click on the Undo Edit gadget and the image will be restored to before the
  202. Flood-Fill).
  203.  
  204.     The Undo Edit gadget will only undo the changes of the LAST edit and not
  205. previous ones.  Certain operations likewise will not be able to be undone
  206. and the gadget will be disabled to inform you of this fact.
  207.  
  208.  
  209.  
  210. SELECTING A DRAWING COLOUR
  211. --------------------------
  212.     To select a colour to draw in, click on one of the colour gadgets down
  213. the right-hand side of the main IE window.  The brush pointer's tip will
  214. change to the selected colour to remind which colour you are using.
  215.  
  216.     AGA users (A1200/A4000) take note:  If you are editing an icon with more
  217. than 16 colours then one of the colours in the palette will change when you
  218. select a colour to use.  This is because non-AGA machines use colour register
  219. 16 to 19 for the mouse pointer.  Apparently the AGA machines use the full 256
  220. registers and I don't as yet have the Workbench3 docs to fix this bug.  This
  221. shouldn't affect your icon at all it only affects the IE display colours.
  222.  
  223.  
  224.  
  225. CHANGING THE ICON'S IMAGE
  226. -------------------------
  227.     To change the colour of a pixel in the icon's image simply position the
  228. pointer in the display window over the pixel you want to change and click
  229. the left mouse button.  The pixel will then change to the currently selected
  230. colour as denoted by the pointer's brush tip.
  231.  
  232.     By holding down the left mouse button and moving the pointer within the
  233. display window the pointer will continuously draw into the image changing
  234. the pixels moved over into the currently selected colour.
  235.  
  236.  
  237.  
  238. THE EDIT MODE GADGETS
  239. ---------------------
  240.     These gadgets allow you to select what type of drawing action is being
  241. performed.  The selections are described below:
  242.  
  243.     DRAW
  244.       Freehand drawing as described in the "CHANGING THE ICON'S IMAGE"
  245.     section above.
  246.  
  247.     FLOOD FILL
  248.       A mouse click within the display window will initiate a "flood" paint.
  249.     The pixel under the pointer is changed to the currently selected colour
  250.     and this continues for all pixels of the same colour "connected" to the
  251.     selected one.  Only horizontal and vertical "connections" are checked for
  252.     flood fill, diagonals are ignored.  This can be used to quickly fill in
  253.     an area instead of painting all of it by hand.
  254.       Remember that the Undo-Edit gadget will restore your image if the flood
  255.     fill "leaks" and destroys your image but it must be done straight away.
  256.  
  257.     WRITE TEXT
  258.       A mouse click within the display window will initiate a text write.  A
  259.     requester is displayed asking for the text to write into the image.  The
  260.     string gadget is automatically activated for you so you can just start
  261.     typing and press the return key when finished.
  262.       If you wish to use a different font, style or colour than the default
  263.     (Topaz/8 - Text Only - White Text) then you can click on the Text Options
  264.     gadget which will then bring up a Font Requester.  This requester allows
  265.     you to scroll through the list of available fonts, select one and apply
  266.     any combination of the style changes bold, italic and underline.  The
  267.     highlighted font name represents the current font.  A sample text in the
  268.     selected font and styles can be seen in the requester to enable you to
  269.     make your decision before leaving the requester.  The selected font and
  270.     style then becomes the default for further text writes.
  271.       The Text colour gadget selects what colour to draw the text in.  The
  272.     Field colour gadget selects what colour to draw the background in.  The
  273.     Mode gadget allows you to select the text drawing mode as detailed below:
  274.         Text Only  - Draw the text but do not disturb the background.
  275.         Text+Field - Draw the text but use a coloured rectangle as a
  276.                      background.
  277.         Complement - Draw the text without disturbing the background.  The
  278.                      selected colours are ignored and the text is written
  279.                      into the image using colours that depend on the
  280.                      background colours it is writing over.
  281.  
  282.  
  283.  
  284. THE MOVE IMAGE ARROW GADGETS
  285. ----------------------------
  286.     Below the Edit Mode gadgets are the Move Image Arrow gadgets.  These
  287. gadgets move the whole icon image in the direction of the gadget.  If you
  288. move the image outside of the boundaries then the image will be trimmed to
  289. fit.
  290.     These are not to be confused with the arrow gadgets next to the scroll
  291. bars as those gadgets are only for fine-tuning the scroll bars.
  292.  
  293.     These gadgets are most useful when you wish to create extra room on top
  294. of, or to the left of, your image in order to do more drawing.  They can
  295. also be used to eliminate "blank" space to the left of your image.
  296.  
  297.     IE will automatically strip the image to the smallest possible size when
  298. saving the icon so it may be faster to save the icon temporarily and reload
  299. it and only use these gadgets to remove the "blank" space that IE could not
  300. remove automatically.
  301.  
  302.  
  303.  
  304. The "PROJECT/NEW" menu item (Right-Amiga N)
  305. -------------------------------------------
  306.     This menu item resets IE to it's defaults for creating a new icon.  It
  307. clears the data in both images and resets the InfoEdit window parameters.
  308.  
  309.  
  310.  
  311. The "PROJECT/LOAD" menu item (Right-Amiga L)
  312. --------------------------------------------
  313.     This menu item will display the file requester to allow you to select
  314. which icon you wish to load.  See the section on the File Requester for
  315. details.
  316.  
  317.  
  318.  
  319. The "PROJECT/LOAD DEFAULT" menu item
  320. ------------------------------------
  321.     The sub-menus of this menu item allow you to select which default icon
  322. you wish to load.
  323.  
  324.     Default icons are used by Workbench to display icons for files that don't
  325. have icons already defined for them.  Workbench has the five icon types
  326. already defined but these defaults can be changed by supplying a new icon as
  327. the default.
  328.  
  329.  
  330.  
  331. The "PROJECT/SAVE" menu item (Right-Amiga S)
  332. --------------------------------------------
  333.     This menu item will save the current icon, or if you haven't selected
  334. an icon name it will display the file requester for you to select one.  See
  335. the section on the File Requester for details.
  336.  
  337.     IE will automatically strip the imagery you designed for the icon to the
  338. smallest possible size, eliminating as much "blank" space as possible,
  339. before saving.
  340.  
  341.  
  342.  
  343. The "PROJECT/SAVE AS" menu item
  344. -------------------------------
  345.     This menu item will display the file requester to allow you to select a
  346. name to save the icon under.  See the section on the File Requester for
  347. details.
  348.  
  349.  
  350.  
  351. The "PROJECT/SAVE AS DEFAULT" menu item
  352. ---------------------------------------
  353.     This menu option will save the current icon to be used as the Workbench
  354. default icon for that type.  The type is determined by the Icon Type
  355. selection in the Edit Info window described later.  Basically you load a
  356. default icon, change the imagery and parameters, and then save as default so
  357. that icon will be used by Workbench in the future.
  358.  
  359.     NOTE:  This menu option will require the icon be saved to your Workbench
  360. disk and will not work if the disk is write-protected.  Also default disk
  361. icons may not take effect until after a system reboot.
  362.  
  363.  
  364.  
  365. The "PROJECT/SAVE & QUIT" menu item (Right-Amiga F)
  366. ---------------------------------------------------
  367.     This menu item will save the current icon, or if you haven't selected
  368. an icon name it will display the file requester for you to select one.  See
  369. the section on the File Requester for details.
  370.  
  371.     After saving the icon IE will then automatically quit.  It is a shortcut
  372. to using the Right-Amiga S and Right-Amiga Q menu items.
  373.  
  374.  
  375.  
  376. The "PROJECT/ABOUT" menu item (Right-Amiga A)
  377. ---------------------------------------------
  378.     This menu item will display information about the program and show you
  379. where you can contact the author.  Press the "OK" gadget when finished
  380. reading each requester.
  381.  
  382.  
  383.  
  384. The "PROJECT/QUIT" menu item (Right-Amiga Q)
  385. --------------------------------------------
  386.     This menu item allows you to quit IE (what else?).
  387.  
  388.  
  389.  
  390. The "ICON/EDIT INFO" menu item (Right-Amiga E)
  391. ----------------------------------------------
  392.     This menu item displays the icon information editing window.  This
  393. window allows you to change the various "non-graphical" options of icons.
  394. Click in the close gadget at the top left when finished.  The options are
  395. summarised below:
  396.  
  397.     ICON TYPE - Simply select the gadget corresponding to type of icon you
  398.     wish to create (DISK, DRAWER, TOOL, PROJECT, TRASHCAN).
  399.  
  400.     HIGHLIGHTING - Select which type of highlighting the icon should have
  401.     when it is selected from Workbench.  COMPLEMENT is to reverse all the
  402.     icon colours within it's select box.  BACKFILL is to reverse all the
  403.     icon colours but only in the image not the background.  ALT RENDER is
  404.     to use the second image (Select Image).
  405.  
  406.     HORIZONTAL POSITION - Select the AUTOMATIC gadget if you wish Workbench
  407.     to automatically try to find a place to fit the icon in.  If the
  408.     AUTOMATIC gadget is turned off then the number in the string gadget
  409.     specifies the exact horizontal placement of the icon.  This can be a
  410.     negative number if the window that the icon is displayed in has been
  411.     scrolled to the left.
  412.  
  413.     VERTICAL POSITION - Same functionality as the Horizontal Position gadgets
  414.     except it is for controlling the vertical placement.  This can also be a
  415.     negative number if the window that the icon is displayed in has been
  416.     scrolled upwards.
  417.  
  418.     DEFAULT TOOL - Type the name of the tool (executable program) which this
  419.     icon is associated with.  The effect of double clicking on this icon
  420.     will be the tool is started and the file associated with this icon will
  421.     be passed to the tool.  The file associated with this icon will only be
  422.     passed to the tool if the tool is set up to receive parameters from
  423.     Workbench otherwise the tool will start as if you selected it directly.
  424.     This gadget will only work with DISK or PROJECT icons.  DISK icons
  425.     should specify a disk copy program for their default tool.
  426.  
  427.     TOOL TYPES - Up to 40 tool types can be specified in this area with the
  428.     scrolling controlled by the scroll bar and arrow gadgets.  Tool Types
  429.     are parameters which are passed to the tool such as "PRINTER=LPT".  The
  430.     tool must be written to accept Tool Types and the tool documentation
  431.     should be able to inform you of the format to use.  Simply click the left
  432.     mouse button over the tooltype line you wish to change and it will be
  433.     copied into the string gadget underneath allowing you to modify it.  To
  434.     add a new tooltype, select a blank line for changing.
  435.  
  436.     OPENED WINDOW - These gadgets enable you to specify the position and size
  437.     of the window which is displayed when the DISK, DRAWER or GARBAGE icon is
  438.     selected.
  439.  
  440.     NAME OFFSET - This enables you to specify a +/- value with which to
  441.     offset the vertical positioning of the icon name.  By specifying a
  442.     positive value the name is moved downwards.  The more usual use is to
  443.     specify a negative value which moves the name upwards.  This can be
  444.     used to centre the icon name within the image of the icon.  NOTE that
  445.     if the name is moved into the icon image only the image portion ABOVE
  446.     the name can be selected with the mouse.
  447.  
  448.     STACK SIZE - This enables you to specify the stack size for the tool
  449.     which is started by the TOOL or PROJECT icon.  A stack size of 0 means
  450.     to use the default stack size (around 4000 bytes), otherwise the stack
  451.     size you specify will be used.
  452.  
  453.     Workbench 2.04 and later has the ability to detect when an icon has been
  454. changed and the change will normally take effect immediately after saving.
  455. The only exception is that when the Opened Window parameters are changed the
  456. icon has to be reloaded by closing the window that contains the icon and
  457. reopening it.  If the icon was a disk icon then you will have to close all
  458. windows from that disk, remove the disk and reinsert the disk.
  459.  
  460.  
  461.  
  462. The "ICON/PREVIEW" menu item (Right-Amiga P)
  463. --------------------------------------------
  464.     This menu item displays the icon preview window.  This window displays
  465. as much of the icon image as possible with no magnification to give you some
  466. idea as to how it will be displayed on Workbench.
  467.  
  468.     Clicking the left mouse button in this window will toggle the display
  469. between the Normal image and the Selected image.  NOTE - The preview window
  470. will only display alternate pictures, the Complement and Backfill select
  471. options cannot be displayed in the preview window.
  472.  
  473.     Clicking the right mouse button will close the window.  The window can
  474. also be closed by the close gadget in the top left of the window.
  475.  
  476.  
  477.  
  478. The "ICON/RECOLOUR" menu item (Right-Amiga R)
  479. ---------------------------------------------
  480.     This menu item will cause second and third colours (usually black and
  481. white) in the icon to be reversed in both icon images.  This is a shortcut to
  482. using the "ICON/SWAP COLOURS" menu item for each image and is provided
  483. especially for changing icons that were created using Workbench 1.3 or
  484. earlier for Workbench 2.04+ usage.
  485.  
  486.  
  487.  
  488. The "ICON/SWAP COLOURS" menu item (Right-Amiga W)
  489. -------------------------------------------------
  490.     This menu item will display a requester where you can choose two
  491. colours to be reversed in the CURRENT image being edited (e.g. you can swap
  492. black with white).
  493.  
  494.  
  495. The "IMAGE/COPY" menu item
  496. --------------------------
  497.     The sub-menus of this menu item allow you to select an image copy
  498. function to use on the loaded icon images.  Using these sub-menus allow you
  499. to duplicate an image into the other icon image or even swap the images
  500. around.
  501.  
  502.  
  503.  
  504. The "IMAGE/SCALE" menu item
  505. ---------------------------
  506.     The sub-menus of this menu item allow to increase or decrease the current
  507. icon image.  This can be used for loading a picture and then shrinking it to
  508. make an icon to represent the picture.  Naturally, decreasing an image will
  509. lose some of the finer details of the image.
  510.  
  511.  
  512.  
  513. The "IMPORT/EXPORT /OUTPUT C CODE" menu item (Right-Amiga C)
  514. ------------------------------------------------------------
  515.     This menu item will display the file requester to allow you to select
  516. a filename to write the C language code for the icon.  See the section on
  517. the File Requester for details.  One use of this is for your programs to
  518. generate their own icons.
  519.  
  520.     The following code example shows how to write an icon file.  This
  521. assumes you generated the C Code to a file called "c-code" and are
  522. generating the icon "test.info":
  523.  
  524.         #include <exec/types.h>
  525.         #include <intuition/intuition.h>
  526.         #include <workbench/workbench.h>
  527.  
  528.         #include <functions.h>
  529.         #include "c-code";  /*ALTERNATIVELY COPY THE CODE HERE FIRST*/
  530.         extern struct IconBase *IconBase;
  531.  
  532.         void main()
  533.  
  534.         {
  535.           IconBase = (struct IconBase *) OpenLibrary("icon.library", 0);
  536.           PutDiskObject("test", &Icon);
  537.           CloseLibrary(IconBase);
  538.           exit();
  539.         }
  540.  
  541.     Another use for the generated C code is for creating gadgets for your
  542. programs.  You can create the gadget image using IE, or load in an IFF
  543. image into IE, and write the C code to a file.  The image data and image
  544. structure generated can then be copied into your program as the data for the
  545. gadget.
  546.  
  547.  
  548.  
  549. The "IMPORT/EXPORT /IMPORT IFF" menu item (Right-Amiga I)
  550. ---------------------------------------------------------
  551.     This menu item displays the file requester to allow you to choose an
  552. IFF picture file to load into the CURRENT image being edited.  This allows
  553. you to use pictures (generated by packages such as DPaint) in your icon
  554. images.
  555.     If importing an IFF file ensure that your icon has at least the same
  556. number of colours as the IFF image or some detail will be lost.
  557.  
  558.  
  559.  
  560. The "IMPORT/EXPORT /EXPORT IFF" menu item (Right-Amiga X)
  561. ---------------------------------------------------------
  562.     This menu item displays the file requester to allow you to choose the
  563. name of the IFF picture to be created from the CURRENT image being edited.
  564. This allows you to export your image to packages with more sophisicated
  565. editing features (such as DPaint) to edit your image and then later import
  566. the edited image back into your icon image.
  567.  
  568.  
  569.  
  570. The "IMPORT/EXPORT /IMPORT FROM ICON" menu items
  571. ------------------------------------------------
  572.     These menu items allow you to grab images directly from other icons.
  573.  
  574.     "NON-SELECT IMAGE" (Right-Amiga 1) allows you to load the Non-Select
  575.     image of an icon into the CURRENT image being edited.
  576.  
  577.     "SELECT IMAGE" (Right-Amiga 2) allows you to load the Select image of
  578.     an icon (if there is one) into the CURRENT image being edited.
  579.  
  580.     "BOTH IMAGES" (Right-Amiga 3) is a shortcut that allows you to load
  581.     both images from an icon into the icon you are currently editing.
  582.  
  583.  
  584.  
  585. FILE REQUESTER
  586. --------------
  587.     IE utilitises the standard file requester provided by Workbench 2.04
  588. whenever a filename is needed for various activities.  The parts of the
  589. file requester are detailed below:
  590.  
  591.     PATTERN GADGET - This gadget allows you to specify a mask which hides
  592.     files that you are not interested in.  For example, the load function
  593.     will only display icon files and directories so you don't accidently
  594.     select a file which isn't an icon.  You may wish to clear the contents of
  595.     this gadget for two reasons:
  596.       Saving an icon - By displaying all files you can select the filename of
  597.                        the program that you wish to attach the icon to.  This
  598.                        will save you typing in the program name!
  599.       Speed          - The Workbench 2.04 file requester can be slow to read
  600.                        the filenames off the disk if pattern matching is
  601.                        being used.  The file requester has less work to do if
  602.                        there is no pattern matching and hence will be faster.
  603.  
  604.     DRAWER STRING GADGET - This gadget is to display the current drawer of
  605.     which the file requester is displaying the names of files in.  You may
  606.     type a new drawer name in here and press return to quickly move to
  607.     another drawer.
  608.  
  609.     FILENAME GADGETS - These display the names of the files in the current
  610.     drawer.  The highlighted gadgets represent drawers and the rest are
  611.     ordinary files.  To select a new drawer to examine just click on the
  612.     drawer name with the left mouse button.  Selecting a filename by clicking
  613.     the left mouse button on the required file will copy the filename into
  614.     the filename string gadget.  Selecting the filename again will act like
  615.     the OK gadget has been pressed and accept the filename as final.
  616.  
  617.     FILENAME STRING GADGET - This gadget displays what the current file is.
  618.     You may type a filename directly in here to quickly select a file or to
  619.     specify the name of a new file.  This gadget is always active and at
  620.     any time you can just start typing in the filename and press return
  621.     when finished.
  622.  
  623.     PARENT GADGET - This gadget will change the current drawer to it's
  624.     parent drawer (that is, the drawer that contains the current drawer).
  625.     Selecting this gadget when at the top most drawer of a disk will have
  626.     no effect.
  627.  
  628.     VOLUMES GADGET - This gadget will cause the file requester to display the
  629.     list of volumes instead of files.  The non-highlighted gadgets represent
  630.     disks or harddrive partitions available.  The highlighted gadgets
  631.     represent logical volumes created by the use of "assign" statements.
  632.     Selecting one of these gadgets will set the current drawer to the
  633.     assigned logical volume or disk.
  634.  
  635.  
  636.  
  637. IE'S AUTOSAVE FUNCTION
  638. ----------------------
  639.     To try to prevent you from losing your work (from power loss, system
  640. failure, etc)  IE will automatically try to save your icon into the file
  641. "IE.AutoSave.info" five minutes after a change has been made to an icon
  642. without the icon being saved.  This file will be automatically deleted if IE
  643. is exited with the "PROJECT/QUIT" or "PROJECT/SAVE & QUIT" menu items.
  644.  
  645.     If IE finds the autosave file present when it starts it will ask if you
  646. want to reload the icon from the autosave file restoring your work.
  647.  
  648.     NOTE the autosave file is created in the directory that IE is started
  649. from and will require the disk is not write-protected.
  650.  
  651.     NOTE also that the DEMONSTRATION version will automatically exit after an
  652. autosave.
  653.  
  654.  
  655.  
  656. PROJECT ICON HINT
  657. -----------------
  658.     If you have some icons that you use regularly then you can create a
  659. "library" of icons by saving them in a drawer as PROJECT icons.  Then by
  660. clicking on an icon, holding down the shift key and double-clicking on the
  661. IE icon you can start IE and IE will automatically load the icon.  You can
  662. then change the icon type, and other characteristics, and use the
  663. "PROJECT/SAVE AS" menu item to save the icon in the desired place and name.
  664.  
  665.     A better method than click, shift, double-click is to change the PROJECT
  666. icon's default tool string to be the full path and name of IE.  Then you
  667. just have to double-click on the desired icon and IE will start and
  668. automatically load the icon as above.
  669.  
  670.  
  671.  
  672. CONFIGURING IE - TOOLTYPES AND CLI PARAMETERS
  673. ---------------------------------------------
  674.     The various configuration settings for IE are controlled by:
  675.  
  676.     TOOLTYPES      - For Workbench users.
  677.     CLI PARAMETERS - For CLI users.
  678.  
  679.     To add tooltypes to the IE icon simply use IE.  Load the IE icon into IE,
  680. select the "ICON/EDIT INFO" menu item and add the tooltype into the tool
  681. types list.  Close the window and save the icon.  Restart IE to use the new
  682. tool types.
  683.     Another method is to select the icon in Workbench and select the "Icons
  684. Information" menu option.  Click on the "New" gadget, enter your tool type
  685. string and click on the "Save" gadget.
  686.     Note that the supplied icon with IE is 8 colours and IE will default to
  687. 4 colours.  If you wish to retain the 8 colours in the icon then it is
  688. advised that you use the "Information" menu option to add the tool type
  689. COLOURS=8 before editing the IE icon with IE.
  690.     Tool types must be entered each on a different line when adding them to
  691. an icon.
  692.     To add CLI PARAMETERS simply add the parameters anywhere on the CLI
  693. command to start IE.  The CLI parameter is the same as the tool type but with
  694. a "-" immediately before it.  This is to stop IE confusing parameters with
  695. icon names.  For example, "IE -INTERLACE" will start IE using an interlaced
  696. screen.
  697.  
  698.  
  699.     The tooltypes and CLI parameters are described below:
  700.  
  701.     TOOLTYPE      -    SUPERHIRES
  702.     CLI PARAMETER -    -SUPERHIRES
  703.         This starts IE using a SUPERHIRES screen resolution.  You need an ECS
  704.     equipped Amiga to use this resolution.  Non-AGA users can only have a
  705.     maximum of 4 colours while in this resolution.  AGA users can have 256.
  706.  
  707.     TOOLTYPE      -    INTERLACE
  708.     CLI PARAMETER -    -INTERLACE
  709.         This starts IE using an interlace screen resolution.
  710.  
  711.     TOOLTYPE      -    COLOURS=<n>
  712.     CLI PARAMETER -    -COLOURS=<n>
  713.         This selects the number of colours that will be in the icon.  Replace
  714.     <n> with the number of colours from 2, 4, 8, 16, 32, 64, 128 or 256.
  715.     For example, "IE -COLOURS=16" will start IE editing icons with 16
  716.     colours.
  717.  
  718.     TOOLTYPE      -    DBLHEIGHT
  719.     CLI PARAMETER -    -DBLHEIGHT
  720.         If you need to create an icon larger than 128 pixels high, this
  721.     parameter will start IE with a maximum height limit of 256 pixels.
  722.  
  723.     TOOLTYPE      -    DBLWIDTH
  724.     CLI PARAMETER -    -DBLWIDTH
  725.         If you need to create an icon larger than 320 pixels wide, this
  726.     parameter will start IE with a maximum width limit of 640 pixels.
  727.  
  728.  
  729.  
  730. A FINAL WORD FROM THE AUTHOR
  731. ----------------------------
  732.     I designed IE to be as simple to use as possible but still possess all
  733. the features required for the construction of icons.  The Amiga has a far
  734. better icon system than ANY of the other machines available and I hope you
  735. use IE to utilise the Amiga's icon system to it's fullest.  If I can be of
  736. any help in your usage of IE or icons then drop me a line.
  737.  
  738.     Thanks must go to all the people who have registered.  Without this
  739. support I would not have made this version.  Thanks also to those users who
  740. made suggestions for how to improve IE.
  741.  
  742.     Here is a count of registrations I have received to date:
  743.  
  744.     Country                         Number
  745.     --------------------------------------
  746.     Australia                         41 (To be expected, I guess)
  747.     Austria                            4
  748.     Canada                             1
  749.     France                             4
  750.     Germany                           36 (Hooray for Germany!!!)
  751.     Holland                            1
  752.     New Zealand                        3
  753.     Sweden                             2
  754.     Switzerland                        4
  755.     United Kingdom                     1
  756.     United States of America          13
  757.  
  758.  
  759.     A very special thanks must go to Leigh Murray of Queanbeyan, Australia
  760. for creating the IEv4.0 icons and beta testing IE for me.
  761.  
  762.     IE is being constantly updated.  If you can think of extra functions that
  763. might be of benefit in IE or some ways IE's interface can be enhanced then
  764. please contact me and I will seriously consider your suggestions.  The best
  765. thing about ShareWare programs are that YOU can make input to them which
  766. might make your life, and somebody elses, a little easier.
  767.  
  768.     If you like IE, or even hate it, please contact me as well as I like to
  769. hear what others think about my efforts.
  770.  
  771.     I hope that this program is of use to you and if you like it give the
  772. demonstration version to all of your friends.
  773.  
  774.     Best wishes and happy Iconing...
  775.       Peter Kiem.
  776.  
  777.